The Define / Action screen allows the creation and maintenance of what happens when an alarm is triggered and may be referenced when defining an alarm.
An Action is a set of notifications that occur when the alarm is triggered. The notification consists of any or all of the following:
The field Disable this Action provides the ability to turn-off (or prevent the processing) of the record without deleting it. However, a disabled Action still results in the default of Send to Screen as Red.
A color is associated with Send to Screen and Send to LOG. Red is considered the most severe and Screen the least. An incrementing alarm starts with on screen, changes to yellow and finally to red based on the Escalation Interval.
The MOMI LOG is an event file maintained by MOMI. It is accessed on the screen LogFile. Send Changes indicates that any change in the Alarm messages is logged. By default, only the first and last (or clear) are logged.
An EMS message may be sent to the $0 collector (default) or an alternate collector. The message has the attributes of Action, Emphasis or Normal as would be shown on the screen EMS Msgs. Send Changes indicates that any change in the Alarm messages is also logged. By default, only the first and last (or clear) are logged.
Email may be sent to either an individual address (Email) or a group of addresses (Email_Group). If an alarm is generated, one email is sent. If the option Send EMAIL when Alarm is Cleared is checked a second email is sent when the alarm is no longer present.
The default format of the EMS and Email message may be overridden and defined by the user when Enable Custom... is checked. Two general formats of alarms are when an alarm is initially triggered (updated), or Set, and when an alarm is no longer present, or Cleared. Text entered by the user appears 'as-is' in the mail. Variables, not case sensitive, are identified by names enclosed within <% .. %> and reference information about the alarm, MOMI and the System. Press the Var button to display a list of variables, which when selected, inserts at the cursor position. In the drop-down list place the mouse over a variable to display a description of the information it represents.
These variables comprise the basic elements of an active alarm:
Alarm-Text
The basic text of an alarm such as:
Process $a is not running
File $data1.proddb.account is 81% full over threshold of 80%
Alarm-Text-Extra
A Second line of additional information such as list of processes, object file name, or other information concerning an alarm.
Alarm-Text-Extra-ML
Some alarms include multiple lines of additional text. For example, the alarm EMS / User defined sets this variable to the EMS event that triggered or cleared the alarm (note this duplicates variable Alarm-Text-Extra). Place this variable on a line by itself. It is not available for single line fields such as an EMS message or the subject of an alarm.
These variables provide a means to access the three basic elements without reporting duplication. They are not available for single line fields such as an EMS message or the subject of an alarm:
Alarm-Text-All-ML
All alarm text representing the variables Alarm-Text, Alarm-Text-Extra, and Alarm-Text-Extra-ML generally without duplication. Data for each underlying variable is provided on one or more lines.
Alarm-Text-Extra-All-ML
All alarm text representing the variables Alarm-Text-Extra and Alarm-Text-Extra-ML generally without duplication. Data for each underlying variable is provided on one or more lines.
Select variables:
Alarm- Date [-GMT]
LCT or GMT Date when alarm first occurred - format : yyyy-mm-dd
Alarm-Time [-GMT]
LCT or GMT Time when alarm first occurred - format: hh:mm:ss
Alarm-Name
Alarm-Description
Name/Description of alarm as given on the screen Alarms / Define / Alarm.
Action-Name
Action-Description
Name/Description of action given on the screen Alarms / Define / Action.
Entity-Name
Process name, file name, EMS Collector name, etc... of specific item triggering the alarm.